/*
 * Copyright (c) 2009-Present, Redis Ltd.
 * All rights reserved.
 *
 * Licensed under your choice of (a) the Redis Source Available License 2.0
 * (RSALv2); or (b) the Server Side Public License v1 (SSPLv1); or (c) the
 * GNU Affero General Public License v3 (AGPLv3).
 */

#ifndef __REDIS_UTIL_H
#define __REDIS_UTIL_H

#include <stdint.h>
#include "sds.h"

/* 将 long double 转为字符串所需的最大字符数。
 * long double 的范围极大（见 LDBL_MAX，可达约 4952 个字符）。
 * 作为 ld2string 的缓冲区大小上限。*/
#define MAX_LONG_DOUBLE_CHARS 5*1024

/* 将 double 转为字符串所需的最大字符数。
 * double 的范围也很大（见 DBL_MAX，约 328 个字符）。
 * 作为使用 %f 的 sprintf 缓冲区大小上限。*/
#define MAX_DOUBLE_CHARS 400

/* d2string / fpconv_dtoa 所需的最大字符数。
 * 因为使用的是 %g 而非 %f，一般 40 个字符已足够。*/
#define MAX_D2STRING_CHARS 128

/* long -> 字符串 + '\0' 所需字节数上限。*/
#define LONG_STR_SIZE      21

/* long double 转字符串的模式选项 */
typedef enum {
    LD_STR_AUTO,     /* 使用格式 %.17Lg */
    LD_STR_HUMAN,    /* 使用格式 %.17Lf，并去除小数末尾无意义的 0 */
    LD_STR_HEX       /* 使用十六进制格式 %La（不丢精度） */
} ld2string_mode;

int prefixmatch(const char *pattern, int patternLen, const char *prefixStr, 
                int prefixStrLen, int nocase);
int stringmatchlen(const char *p, int plen, const char *s, int slen, int nocase);
int stringmatch(const char *p, const char *s, int nocase);
int stringmatchlen_fuzz_test(void);
unsigned long long memtoull(const char *p, int *err);
const char *mempbrk(const char *s, size_t len, const char *chars, size_t charslen);
char *memmapchars(char *s, size_t len, const char *from, const char *to, size_t setlen);
uint32_t digits10(uint64_t v);
uint32_t sdigits10(int64_t v);
int ll2string(char *s, size_t len, long long value);
int ull2string(char *s, size_t len, unsigned long long value);
int string2ll(const char *s, size_t slen, long long *value);
int string2ull(const char *s, unsigned long long *value);
int string2l(const char *s, size_t slen, long *value);
int string2ul_base16_async_signal_safe(const char *src, size_t slen, unsigned long *result_output);
int string2ld(const char *s, size_t slen, long double *dp);
int string2d(const char *s, size_t slen, double *dp);
int trimDoubleString(char *buf, size_t len);
int d2string(char *buf, size_t len, double value);
int fixedpoint_d2string(char *dst, size_t dstlen, double dvalue, int fractional_digits);
int ld2string(char *buf, size_t len, long double value, ld2string_mode mode);
int double2ll(double d, long long *out);
int yesnotoi(char *s);
sds getAbsolutePath(char *filename);
long getTimeZone(void);
int pathIsBaseName(char *path);
int dirCreateIfMissing(char *dname);
int dirExists(char *dname);
int dirRemove(char *dname);
int fileExist(char *filename);
sds makePath(char *path, char *filename);
int fsyncFileDir(const char *filename);
int reclaimFilePageCache(int fd, size_t offset, size_t length);
char *fgets_async_signal_safe(char *dest, int buff_size, int fd);
int vsnprintf_async_signal_safe(char *to, size_t size, const char *format, va_list ap);
#ifdef __GNUC__
int snprintf_async_signal_safe(char *to, size_t n, const char *fmt, ...)
    __attribute__((format(printf, 3, 4)));
#else
int snprintf_async_signal_safe(char *to, size_t n, const char *fmt, ...);
#endif
size_t redis_strlcpy(char *dst, const char *src, size_t dsize);
size_t redis_strlcat(char *dst, const char *src, size_t dsize);

/* 保持无条件快速：仅适用于 0 < x < 2^63。返回 ceil(log2(x))。*/
static inline int log2ceil(size_t x) {
#if UINTPTR_MAX == 0xffffffffffffffff
    return  63 - __builtin_clzll(x);
#else
    return 31 - __builtin_clz(x);
#endif
}

#ifndef static_assert
#define static_assert(expr, lit) extern char __static_assert_failure[(expr) ? 1:-1]
#endif

#ifdef REDIS_TEST
int utilTest(int argc, char **argv, int flags);
#endif

#endif
